
  TSpinDblEdit  and  TDBSpinDblEdit
  Version 1.5e
   
   (c) copyright 1996-97 W. Braun  All Rights Reserved
 

   Delphi 1-3 / C++ Builder VCL-Komponenten
   
  



Liebe Entwickler und Anwender ,

mit diesen Komponenten knnen Sie alle numerischen Ein-/Ausgabefelder
in Ihrer Applikation abdecken und erreichen so ein  einheitlich
formatiertes Erscheinungsbild Ihrer Anwendung.
 
Ich hoffe diese Komponenten helfen euch bei der Arbeit und machen
diese etwas leichter.



Inhalt
  
   1. Installation
   2. Neu
   3. Eigenschaften
   4. Funktiosbeschreibung
   5. Registrierung
   6. Glossar	 
   7. Warranty
   8. Shareware 	

1. Installation 

I. Delphi 1-2
   Bitte benutzen Sie fr die 16-Bit Version die Datei "D_16.ZIP" und 
   fr die 32-Bit Version die Datei "D_32_2.ZIP".

   1. Kopieren Sie bitte die Dateien  DEdSpin.DCU, DEdSpin.DCR, DEdSpin.RES,
      Calc.DCU und Calc.DFM  in ein beliebiges von Ihnen
      bevorzugtes Verzeichniss, z.B. C:\DELPHI\Z_COMP
   2. Whlen Sie im Delphi-Men Optionen | Komponenten installieren
   3. Klicken Sie auf Hinzufgen
   4. Geben Sie jetzt das Verzeichniss und DEDSPIN.DCU ein, 
      z.B. C:\DELPHI\Z_COMP\DEDSPIN.DCU 
   5. Klicken Sie jetzt OK
   6. Nochmal OK
   
II. Delphi 3
   Bitte benutzen Sie die Datei "D_32_3.ZIP"
   1. Kopieren Sie bitte die Dateien  DEdSpin.DCU, DEdSpin.DCR, DEdSpin.RES,
      Calc.DCU und Calc.DFM  in ein beliebiges von Ihnen
      bevorzugtes Verzeichniss, z.B. C:\DELPHI\Z_COMP
   2. Whlen Sie im Delphi-Men Komponenten | Komponenten installieren
   3. Whlen sie ihre bevorzugte package ( default dclusr30dpk) und
      klicken Sie auf Hinzufgen
   4. Geben Sie jetzt das Verzeichniss und DEDSPIN.DCU ein, 
      z.B. C:\DELPHI\Z_COMP\DEDSPIN.DCU 
   5. Klicken Sie jetzt Compilieren 
   6. Folgen Sie den Anweiseungen bis zur Meldung, da 
      TSpinDblEdit unf TDBSpinDblEdit registriert sind, erscheint
   7. Speichern Sie das package ab. 

III. C++ Builder
   Bitte benutzen Sie fr die Datei "D_CB.ZIP"

   1. Kopieren Sie bitte die Dateien  DEdSpin.OBJ, DEdSpin.HPP, DEdSpin.DCR, 
      DEdSpin.RES, Calc.OBJ, Calc.HPP und Calc.DFM  in ein beliebiges von Ihnen
      bevorzugtes Verzeichniss, z.B. C:\CBUILDER\Z_COMP
   2. Whlen Sie im Men Optionen | Komponenten installieren
   3. Klicken Sie auf Hinzufgen
   4. Geben Sie jetzt das Verzeichniss und DEDSPIN.OBJ ein, 
      z.B. C:\CBUILDER\Z_COMP\DEDSPIN.OBJ
   5. Klicken Sie jetzt OK
   6. Nochmal OK


Nach kompilierung der VCL durch Delphi/C++ Bulder erscheint jetzt in Ihrer
Komponenten-Leiste eine zustzliche Leiste 'WB', hier finden Sie
die neuen Komponenten.

Jetzt mssen Sie nur noch diese Komponenten anklicken und danach
auf Ihr Formular an der gewnschten Position setzen.

2. Neu

Version 1.5e (08.08.1997)

-die Tasten ALt+Hoch/Runter ffnen den Taschenrechner (wie ComboBox) 
 Anregung von Thomas Grusche, 100027.231@compuserve.com
-Eigenschaft ActiveColor 
 Anregung von G.Schmitthenner, Calcul-Schmitthenner@t-online.de 
-Eigenschaft CalcColor
-Fehlerbehebung bei Ctl3D = False
-Vererbte Eigenschaften wie BorderStyle sind nun auch in Delphi 2+3 voll verffentlicht


Version 1.5d
Ereigniss OnCalClick
Ereigniss OnCalOpen
Ereigniss OnCalClose
Ereigniss OnSpinDownClick
Ereigniss OnSpinUpClick



3. Eigenschaften und Ereignisse ( Properties and events )

Folgende Eigenschaften und Ereignisse gelten fr beide Komponenten

TSpinDblEdit, TDBSpinDblEdit


Properties :

ActiveColor     TColor, default clWindow
Alignment       default taRightJustify
AutoCalculator  boolean, pops the calculator OnEnter, default False 
CalcColor       TColor, default clBackGround
CalcDigitsNo    Integer, different DigitsNo for Calculator, 
                result will be rounded.
		Please set after DigitsNo.
Calculator      boolean, Calculatorbutton on/off, default off
CalcHelpContext Integer, HelpContext for Calculator
CalcPosition    Position of Calculatorform, default posAbove
                [posAbove,posBelow,posLeft,posRight,posOnTop]
DigitsNo        Integer,  Digitsnumber  default 2, Min 0 , Max 10
Increment       double, Increment for spin
Info            InfoMessageBox about this component
MaxLength       integer, MaxLength of number (incl. Decimalseparator),
		default 10, Max 30, Min 1 ( DigitsNo = 0 )
		Normally calculated from Max-/MinValue
MaxValue	Double 
MinValue 	Double. If MinValue> = 0 and MaxValue<>MinValue then
		you can't entry negative number
NegColor	TColor, color negative Value
NegFontColor	TColor, fontcolor negative Value
PosFontColor	TColor,  fontcolor positive Value
Spin 		boolean, Spinbuttons on/off, default off
		If Spin is on use the Incrementvalue 
                like TSpinEdit (standard Delphi component )
ThousSeparator 	boolean, Thousandseparator in Value, default True 
Value 		Double

Events 

OnCalClick      Calculator button click
OnCalOpen	Calculator open
OnCalClose      Calculator close
OnSpinDownClick Down button click
OnSpinUpClick   Up button Click 


Additional  the TDBSpinDblEdit have follows properties

DataField	NumericalField , Datatype ftSmallint, ftInteger, ftWord,
		ftFloat, ftCurrency
DataSource	DataSource for Table or Query


        	
Andere Eigenschaften sind aus der TCustomerEdit-Klasse vererbebt.

4. Beschreibung

TSpinDblEdit dient der Vereinfachung der Eingaben und /oder Berechnung
von realen und ganzen Zahlen. Die standardmig mitgelieferten 
Werkzeuge von Borland sind nur sehr eingeschrnk zu gebrauchen 
( s. TMaskEdit). 
Die Eingabe der Zahlen in TSpinDblEdit erfolgt wie bei einem
Taschenrechner : Vorkommastellen von rechts nach links, 
Nachkommastellen von links nach rechts. 
Bei Eingabe vom  Negationszeichen wird die aktuelle Zahl sofort
negiert.
Der Unterschied zum Taschenrechner besteht natrlich in den
Editierfhigkeiten und den vom Programmierer fest vorgegebenen
Nachkommastellen und maximalen Anzahl der Vorkommastellen. 


Bei einer normalen Zahleneingabe werden die Vorkammastellen
von links aufgefllt und beim erreichen der vom Programmierer
festgelegten maximalen Vorkommastellenanzahl zu der ersten
Nachkommastelle gewechselt. Beim Drcken des Dezimalzeichens
springt der Cursor automatisch auf die erste Nachkommastelle.
Alignment setzt die Ausrichtung der Zahl im Eingabefeld : 
rechts ( standart), zentriert oder linksbndig. 
DigitsNo ist die Anzahl der Nachkommastellen. Wenn keine Zahlen
eingegeben werden wird immer mit Null aufgefllt
( z.B. 1.00 wenn DigitsNo = 2).
Wenn die Eigenschaft ThousandSeparator auf True gesetzt ist
werden die Tausendertrennzeichen automatisch eingefgt und 
vom Cursor bersprungen.
NegColor und NegFontColor erlaubt ihnen eine andersfarbige
Darstellung der negativen Zahlen zur optischen Hervorhebung.
MinValue, MaxValue und Maxlength sind Eigenschaften zum setzen
der max. bzw. mindest Werte. Diese Eigenschaften beinfluen
sich gegenseitig. Unsinnige Eigenschaften werden weitgehends
abgefangen ( z. B. MinValue > MaxValue , MaxLength < Length(MaxValue)
usw. ) .
Value ist der aktuelle Anfangswert der Eingabe nach Erstellung der Form.
Spin ermglicht Ihnen eine einfache Addition bzw. Subtraktion
der aktuellen Eingabe um den in der Eigenschft Increment
eingegebenen Zahl indem Sie das Symbol Pfeil nach unten (Subtraktion)
oder das Symbol Pfeil nach oben ( Addition ) drcken.
Sie knnen auch die Tasten Pfeil nach oben bzw. Pfeil nach unten
benutzen.
Calculator erlaubt Ihnen dem Anwender einen Taschenrechner
zur Verfgung zu stellen.
Nach dem anklicken des Symbols fr den Taschenrechner wird
ein Taschenrechner angezeigt mit dem der Anwender Berechnungen
anstellen kann und danach das Ergebnis in das Eingabefeld bernehmen
kann. Der Taschenrechner ist ein nicht modales Fenster ohne Rahmen.
Er wird geschlossen durch :
1. drcken der <Return>-Taste, Ergebniss wird bernommen
2. Anclicken des Schalters '<=' (bernahme) , Ergebniss wird bernommen
3. drcken der <Escape-Taste>, Abbruch
4. Klicken mit der Mouse auerhalb des Taschenrechnerfensters, Abbruch

Forhandene Funktionen sind Addition, Subtraktion, Multiplikation,
Division, Prozentrechnung, Memory-Berechnung.


Die zustzlichen Eigenschaften der TDBSpinDblEdit-Komponenten dienen
der direkten Datenbankanbindung und knnen zur Anzeige bzw.
Manipulation der Daten der verbundenen Felder einer Tabelle
oder Anfrage benutzt werden. DataField kann sowohl einen integer
wie auch einen float Typ angeben. Wenn die verbundene 
Tabelle/Anfrage whren des Setzens der Eigenschaften von 
TDBSpinDblEdit in der Entwicklungsumgebung aktiv ist 
( d.h. die Eigenschaften des verbundenen Feldes sind bekannt ) 
werden die Eigenschaften MaxValue, MinValue und DigitsNo 
automatisch denen des verbundenen Feldes gleichgesetz und 
mssen nicht mehr nachbearbeitet werden. 

Andere Eigenschaften sind aus der TCustomerEdit-Klasse bernommen worden.

5. Registrierung

Die Demo-Version beinhaltet alle Funktionen der Vollversion, 
kann aber seit dieser Version nur unter der Entwicklungsumgebung
eingesetzt werden.

Bemerkung : fr C++ Builder bitte nur mit Source-Code registrieren !!!

Registrierung

Der Preis fr diese Komponenten ist 
 - $15.00 (US) ohne SourceCode 
 - $30.00 (US) mit SourceCode ( >2000 Zeilen). 

Bestellen knnen Sie wie folgt :

a. CompuServe's Online Registration :  GO SWREG
 
   TSpinDateEdit : -File-ID 14245  without Source
                   -File-ID 14900  with    Source
   TGermDateEdit : -File-ID 15615  without Source
                   -File-ID 15616  with    Source
      Update from TSpinDateEdit : 
                   -File-ID 15617  without Source
      Update from TSpinDateEdit : 
                   -File-ID 15618  with    Source
   TSpinDblEdit :  -File-ID 12832  without Source
                   -File-ID 14901  with    Source   


b. Order by sending me an e-Mail.
c. Fill out and send the order form "order.txt" 

6. Glossar

Wenn Sie Fragen oder Anregungen haben schicken Sie mir ein paar Zeilen
per eMail.
Ich bin fr jeden guten Vorschlag dankbar.


MfG 

Ihr Wilhelm Braun


eMail : 106216.1307@compuserve.com
Fax  :  +49 0621 6296754


7. Warranty


THIS SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS" AND WITHOUT 
WARRANTIES AS TO PERFORMANCE OR MERCHANTABILITY.

THESE COMPONENTS ARE PROVIDED WITHOUT ANY EXPRESS OR IMPLIED 
WARRANTIES WHATSOEVER. BECAUSE OF THE DIVERSITY OF 
CONDITIONS AND HARDWARE UNDER WHICH THESE COMPONENTS MAY BE 
USED, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS 
OFFERED. THE USER IS ADVISED TO TEST THESE COMPONENTS THOROUGHLY 
BEFORE RELYING ON THEM. THE USER MUST ASSUME THE ENTIRE RISK 
OF USING THESE COMPONENTS. 


8. Shareware

THESE COMPONENTS ARE SHAREWARE. 
You may use the shareware version of these components for a 30 day
trial period. If you would like to continue to use these components
after the 30 day trial period, you are required to purchase the
licensed version of these components.


